home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 2000 January / Macworld (2000-01).dmg / Shareware World / Utilities / User Interface / SwitchRes 2.2.1.sea / SwitchRes 2.2.1 ƒ / Read me < prev    next >
Text File  |  1999-10-20  |  15KB  |  248 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Version 2.2.1
  8.  
  9.                                        Stéphane Madrau
  10.  
  11.  
  12. Introduction
  13.  
  14. SwitchRes is an utility built around a Control Panel and an Extension. It will allow you to control and automate the resolutions of all your monitors. It is distributed with a Control Strip Module and a Contextual Menu Item, so that it’s always available everywhere.
  15.  
  16. SwitchRes is completely configurable. You can define which resolutions are really accessible, and which will require a confirmation. A new option allows you to redirect a resolution on an other, in all applications.
  17.  
  18. You can save the position of the icons on your desktop, independently from one resolution to the other, unlike the Finder. The position of the icons is restored at startup.
  19.  
  20. You can also create ‘display sets’ which will allow you to change the resolution, the depth and position of all your monitors, and to use an AppleScript with one click, or one key.
  21.  
  22. You can assign a specific Set to an application, so that every time you use this application, your Mac will automatically switch to predefined resolutions.
  23.  
  24. Configuration
  25.  
  26. SwitchRes will require a Mac with at least MacOS 8. SwitchRes is fully compatible with MacOS 8.5 (and 8.6) and will use all its features (Navigation Services, theme–switchable Appearance, PowerPC version of the Control Strip Module, Location Manager Module…)
  27.  
  28. Shareware
  29.  
  30. SwitchRes is distributed as a $15 shareware. This version is an evaluation version. You can use it for 10 days. After that, the preferences saving and restoring will be deactivated. To unlock SwitchRes, you will have to register. You can use the included ‘Register’ application.
  31. Don’t forget to write your address or eMail address, so that you can get the key to register.
  32.  
  33. Previous users of SwitchRes 1.x can upgrade for a special price. Please contact the author or take a look at the ‘Register’ application for more information.
  34.  
  35.                                                                                                                                                                                                                                              
  36. Installation
  37.  
  38. First, you’ll need to remove all previous version of SwitchRes extension in the Extensions folder.
  39.  
  40. Then, just drag and drop the ‘SwitchRes’ Extension and the ‘SwitchRes Control’ Control Panel on your system folder.
  41.  
  42. If you want to use the Control Strip Module, the Contextual Menu Item or the Location Manager module, drag them onto your System Folder too.
  43.  
  44. Then you have to restart your computer to use SwitchRes.
  45.  
  46. Note: Only the Extension is required to be in the System Folder. The Control Panel may be stored anywhere on your disk.
  47.  
  48.                                                                                                                                                                                                                                                 
  49. User interface – the menus
  50.  
  51. First menu
  52.  
  53. After restart, you have access to the SwitchRes menu in one of the following locations:
  54. – in the menu bar
  55. – in the Control Strip
  56. – in the Contextual Menu when clicking on the desktop
  57.  
  58. This menu will look like this:
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. if you have more than one display, then the display–specific options are grouped into hierarchical submenus:
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75. You can choose the resolution and the depth of the all monitors. 
  76.  
  77. The resolutions in italic (like 640 x 480, 120Hz) will require the traditional confirmation box. This dialog will be displayed for 5 seconds.
  78.  
  79. All options shown in this menu are completely configurable. You can choose to only show some options, independently from one menu to the other.
  80.  
  81. Secondary menu
  82.  
  83. The secondary menu will be displayed in the Control Strip by clicking on the SwitchRes icon while holding down the ‘’ key:
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90. This menu allows you to open the Control Panel. The Control Panel can also be opened on the Finder with a double-click on its icon.
  91.  
  92.                                                                                                                                                                                                                                                 
  93. Settings – The SwitchRes Control Panel
  94.  
  95. The Control Panel has 5 parts, each represented by a button on the upper side of the dialog.
  96. Preferences are saved when quitting the Control Panel or closing the dialog. All settings are applied immediately.
  97.  
  98. First part: General Preferences 
  99.  
  100.  
  101.  
  102.  
  103.  
  104. The buttons shown in this part of the dialog allow you to:
  105.  
  106. • Allow or forbid all resolutions changes during the startup process. Try this option if you have an AppleVision or ColorSync ADB–driven monitor.
  107.  
  108. • Show or hide the SwitchRes icon at startup
  109.  
  110. • Set the resolution of every monitor attached after restart, let the Location Manager apply the 
  111. correct settings, or use a specific Display Set;
  112.  
  113. • Change the delay of icon repositioning at startup. In order to wait for external hard drives to mount on the desktop, this delay is modifiable.
  114.  
  115. • Automatically save the positions of the icons of the desktop when a switch occurs. The button on the right or the last command of the menu is devoted to do this manually, which can be time saving if you don’t change your icons frequently;
  116.  
  117. • Use the Navigation Services in the Control Panel
  118.  
  119. • Use a System–wide key shortcut for opening the Control Panel
  120.  
  121. • Add the Monitor number after its name
  122.  
  123. • Activate the advanced user mode. In this mode, you won’t see any alert any more. Use this only if you know what you are doing.
  124.  
  125.                                                                                                                                                                                                                                                 Second part: 
  126.  
  127.  
  128.  
  129.  
  130.  
  131. You can see the resolution list of every monitor. The button under the list allows you to display all resolutions your video card is capable of. Warning: your monitor may not support all these resolutions. I’m not responsible of any damage caused to your monitor.
  132. Moreover, your video card does not necessarily handle these resolutions. In this case, no resolution change occurs.
  133.  
  134.  
  135. From left to right, in the list, you can see:
  136. • The resolution itself
  137. • The vertical refresh rate of this resolution
  138. • If this resolution is allowed or not (cross in the column if resolution is forbidden). With a control-click on this column, you can define the redirection of this resolution to an other one. This will allow you to play games in 640x480, 120Hz when they woud normally change the resolution to 640x480, 67Hz. Your eyes will like that!
  139. • If this resolution is displayed in the menu or not, or if it requires a confirmation alert box
  140. • If this resolution owns an icon setting
  141.  
  142. Under this list, the options allow you to:
  143.  
  144. • Configure the menu: by displaying the refresh rate in the menu
  145. (Example: “640 x 480” or “640 x 480, 120Hz”)
  146. and by displaying a custom monitor type
  147. (Example: “Multiscan monitor”, “21” Multiscan monitor” or whatever you want)
  148.  
  149. • Keep same color depth – You can specify to keep the same depth or to use the deepest available when switching in a new resolution.
  150.  
  151. The Setup Wizard is a quick–and–easy way to configure your monitor: imagine you have to plug your PowerBook on a unknown external monitor, for a presentation. You just can select this tool and you’ll quickly have SwitchRes correctly configured for the right resolution.
  152.  
  153. You can give the wizard some clues about the physical characteristics of your monitor. These can be found in your monitor’s manual. SwitchRes will then activate only the resolutions that fall into these characteristics and will ask you to confirm that these resolutions are really visible.
  154.  
  155. Note that you can launch the Setup Wizard automatically at startup, by pressing the ‘S’ key during the restart. SwitchRes will play a little sound, telling you that your order has been taken into consideration, and will present you the standard testing dialog. This will allow a configuration of a monitor where you cannot see the screen at startup.
  156.  
  157.  
  158.                                                                                                                                                                                                                                                 Third part: 
  159.  
  160.  
  161.  
  162.  
  163.  
  164. In this part, you define the Display Sets.
  165. Display Sets are SwitchRes’ most useful feature. Their possibilities are far more advanced than only applying some resolution or depth changes. In fact, with AppleScript, they allow you to do almost everything, easily.
  166.  
  167. A Display Set contains the settings of all your monitors. This includes monitor resolution, color depth and even monitor position in a multiple display environment. Moreover, they can contain an AppleScript that will allow you to execute some actions when the set will be selected.
  168.  
  169. The Display Sets are activated either by a Key Shortcut, a selection in one menu, when an application starts, or brought to the front, and even at startup.
  170.  
  171. For each of these events, the Set will be applied. This goes far beyond a simple resolution change, because with just one key you might want to tell SwitchRes to open an application and automatically use the correct display settings.
  172.  
  173. Moreover, SwitchRes is smart enough to remember the display settings of monitors that are not attached permanently. That allows you to use the same Set on your PowerBook, whether the computer is used with the internal screen or with a second display attached.
  174.  
  175. Last, the order in which Display Sets are shown in a menu is user–configurable. Just drag the Display Set’s name where you want it to appear, and all will be drawn consequently.
  176.  
  177.  
  178.                                                                                                                                                                                                                                                 Fourth part: 
  179.  
  180.  
  181.  
  182.  
  183.  
  184. In this part, you define the application settings. You can define settings that will be used for every application, and other settings that will be used for certain applications only, when the application is launched or brought to the front.
  185.  
  186. The principal settings are the Display Set and the sound level. That will allow you to launch a game with a correct sound level, and with the correct screen size. Of course, the older settings can be restored when the application quits.
  187.  
  188. Other interesting options in this section are:
  189. • Automatically hiding the Control Strip and the other Applications
  190. • Restoring the older settings when the application quits
  191. • Applying again the defined settings when the application is brought to front
  192.  
  193. The last application definable option is the ability to forbid every resolution change coming from the application itself. Only SwitchRes will be able to change the resolution. This is useful for games that will change your monitor to an hard–coded resolution.
  194.  
  195.                                                                                                                                                                                                                                                 Fifth part: 
  196.  
  197.  
  198.  
  199.  
  200.  
  201. This part lets you define what you want to see in the 3 SwitchRes menus: the Control Strip Menu, the Menu in the Menu bar and the Contextual Menu.
  202.  
  203. Here you can also activate or deactivate the menu in the menu bar of each application:
  204.  
  205.  
  206.  
  207. Try everything to choose what you like the most…!
  208.  
  209.                                                                                                                                                                                                                                                 
  210. Various
  211.  
  212. Comments
  213.  
  214. For all comments, you can email me at:
  215.                madrau@kagi.com.
  216.  
  217. Thanks to…
  218.  
  219. David Nine, Tobias Jachmann, Mike Gerenser, Michael Kummer, Norbert M. Doerner, Kiran Wagle, John Moreno, John Zetlaoui for beta testing;
  220. Christoph Sahm for the German localisation, Joris Provoost for the Dutch one and Stefano Ghielmi for the Italian one;
  221. Ammon Skdimore for his help and some code exchange.
  222. Andreas Bauer for all the beautiful 32 bit icons.
  223.  
  224. History
  225.  
  226. New in version 2.2.1
  227. • Corrects a bug that prevented your Mac to go to sleep under MacOS 9.0 with Muliple User on. This could be dangerous when trying to close a Powerbook, because cooling was not assured.
  228. • Added compatibility with MacOS 9.0 and Multiple User: each user has its own preferences, its own Display Sets and its own Applications. 
  229. • Sometimes a video card could be prevented to use an added resolution, and the Mac began to swap between the old and the new resolution. This is corrected.
  230. • SwitchRes 2.2 added MacPortrait 6.2 compatibility, but lost 6.0.x compatibility. This is now corrected.
  231. • Pressing the Key shortcut for opening the Control Panel when it is already open will swap its window from one screen to the next.
  232.  
  233. New in version 2.2
  234. • A resolution can be redirected to one other resolution: if you want to use 640x480, 120Hz instead of 640x480, 67Hz you can control-click on the source resolution and tell it to point to a specific destination.
  235. It's the same than aliases in the Finder on resolutions. This will avoid you using different application settings when you don't need.
  236. • Application settings: you can tell SwitchRes to avoid a resolution change in all applications.
  237. • If you start your Mac 'blind', without anything displayed you can press ‘S’ during startup. That will launch the setup wizard automatically.
  238. • SwitchRes is now compatible with MacPortrait 6.2. All resolutions added by MacPortrait are shown in SwitchRes.
  239.  
  240. • Balloon help has been added in the Control Panel. A better support is planned in the future.
  241. • Menus have been improved: empty hierarchical menus won't appear any more, and display sets can be put in hierarchical menus.
  242.  
  243. • A constant redraw of the application list, causing it to flicker, has been corrected
  244. • SwitchRes now correctly works on Powerbook G3 “bronze”. It didn't work before because the resolution list on this machine depends on wheteher you have a second display attached or not.
  245. • SwitchRes works with MacOS 9. The icons positionning scheme has changed in the Finder 9, and SwitchRes takes that into account to be compatible with MacOS 9. (Finder 9 don’t allow repositionning of the icons when the desktop is in ‘snap to grid’ mode).
  246.  
  247. • Frequency is calculated in a different way, so that “75Hz” can become “74.9Hz” now.
  248. • A cosmetic glitch, visbile with the “QLike” theme, is now corrected.